Xbasic

a5_scale_imagefile Function

Syntax

V a5_scale_imageFile(C filenameIn ,C filenameOut ,N scale [,N maxSize [,C units [,C appliesto [,C scaleMethod [,N width [,N height [,L flagOKToUseImageMagic ]]]]]]])

Arguments

filenameInCharacter

Name of image file to scale.

filenameOutCharacter

Name of scaled image file.

scaleNumeric

A decimal number to scale the image. E.g. 0.5 = 50% of original size, 1.5 = 150% of original size. If scale is set t 0, you can specify the maxSize.

maxSizeNumeric

Default = 0. The dimension in inches or pixels of the height, width, or maximum dimention of the image. If size is 0, you can specify the maxSize property.

unitsCharacter

Default = "inches". Defines the dimension unit for the maxSize property. Can be "inches" or "pixels".

appliestoCharacter

Default = "Max". The dimension the maxSize is applied. appliesto can have a value of "Width" (maxSize is applied to the image width), "Height" (maxSize is applied to the image height), or "Max" (maxSize is applied to larger of width and height.)

scaleMethodCharacter

Default = "Proportional". Defines the scaling method.

widthNumeric

Default = 0.

heightNumeric

Default = 0.

flagOKToUseImageMagicLogical

Default = .T..

Description

Scales an image file.

Discussion

The a5_scale_imagefile function scales an image file. The following image types are supported: .png, .jpg, .jpeg, .bmp.